home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / sysconf.0 < prev    next >
Text File  |  1996-09-02  |  5KB  |  152 lines
  1.  
  2. SYSCONF(3)                 UNIX Programmer's Manual                 SYSCONF(3)
  3.  
  4. NNAAMMEE
  5.      ssyyssccoonnff - get configurable system variables
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _l_o_n_g
  11.      ssyyssccoonnff(_i_n_t _n_a_m_e)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      This interface is defined by IEEE Std1003.1-1988 (``POSIX''). A far more
  15.      complete interface is available using sysctl(3).
  16.  
  17.      The ssyyssccoonnff() function provides a method for applications to determine
  18.      the current value of a configurable system limit or option variable.  The
  19.      _n_a_m_e argument specifies the system variable to be queried.  Symbolic con-
  20.      stants for each name value are found in the include file <unistd.h>.
  21.  
  22.      The available values are as follows:
  23.  
  24.      _SC_ARG_MAX
  25.              The maximum bytes of argument to exec(2).
  26.  
  27.      _SC_CHILD_MAX
  28.              The maximum number of simultaneous processes per user id.
  29.  
  30.      _SC_CLK_TCK
  31.              Number of micro-seconds per hz tick.
  32.  
  33.      _SC_NGROUPS_MAX
  34.              The maximum number of supplemental groups.
  35.  
  36.      _SC_OPEN_MAX
  37.              The maximum number of open files per user id.
  38.  
  39.      _SC_STREAM_MAX
  40.              The minimum maximum number of streams that a process may have
  41.              open at any one time.
  42.  
  43.      _SC_TZNAME_MAX
  44.              The minimum maximum number of types supported for the name of a
  45.              timezone.
  46.  
  47.      _SC_JOB_CONTROL
  48.              Return 1 if job control is available on this system, otherwise
  49.              -1.
  50.  
  51.      _SC_SAVED_IDS
  52.              Returns 1 if saved set-group and saved set-user ID is available,
  53.              otherwise -1.
  54.  
  55.      _SC_VERSION
  56.              The version of ISO/IEC 9945 (POSIX 1003.1) with which the system
  57.              attempts to comply.
  58.  
  59.      _SC_BC_BASE_MAX
  60.              The maximum ibase/obase values in the bc(1) utility.
  61.  
  62.      _SC_BC_DIM_MAX
  63.              The maximum array size in the bc(1) utility.
  64.  
  65.      _SC_BC_SCALE_MAX
  66.  
  67.              The maximum scale value in the bc(1) utility.
  68.  
  69.      _SC_BC_STRING_MAX
  70.              The maximum string length in the bc(1) utility.
  71.  
  72.      _SC_COLL_WEIGHTS_MAX
  73.              The maximum number of weights that can be assigned to any entry
  74.              of the LC_COLLATE order keyword in the locale definition file.
  75.  
  76.      _SC_EXPR_NEST_MAX
  77.              The maximum number of expressions that can be nested within
  78.              parenthesis by the expr(1) utility.
  79.  
  80.      _SC_LINE_MAX
  81.              The maximum length in bytes of a text-processing utility's input
  82.              line.
  83.  
  84.      _SC_RE_DUP_MAX
  85.              The maximum number of repeated occurrences of a regular expres-
  86.              sion permitted when using interval notation.
  87.  
  88.      _SC_2_VERSION
  89.              The version of POSIX 1003.2 with which the system attempts to
  90.              comply.
  91.  
  92.      _SC_2_C_BIND
  93.              Return 1 if the system's C-language development facilities sup-
  94.              port the C-Language Bindings Option, otherwise -1.
  95.  
  96.      _SC_2_C_DEV
  97.              Return 1 if the system supports the C-Language Development Utili-
  98.              ties Option, otherwise -1.
  99.  
  100.      _SC_2_CHAR_TERM
  101.              Return 1 if the system supports at least one terminal type capa-
  102.              ble of all operations described in POSIX 1003.2, otherwise -1.
  103.  
  104.      _SC_2_FORT_DEV
  105.              Return 1 if the system supports the FORTRAN Development Utilities
  106.              Option, otherwise -1.
  107.  
  108.      _SC_2_FORT_RUN
  109.              Return 1 if the system supports the FORTRAN Runtime Utilities Op-
  110.              tion, otherwise -1.
  111.  
  112.      _SC_2_LOCALEDEF
  113.              Return 1 if the system supports the creation of locales, other-
  114.              wise -1.
  115.  
  116.      _SC_2_SW_DEV
  117.              Return 1 if the system supports the Software Development Utili-
  118.              ties Option, otherwise -1.
  119.  
  120.      _SC_2_UPE
  121.              Return 1 if the system supports the User Portability Utilities
  122.              Option, otherwise -1.
  123.  
  124. RREETTUURRNN VVAALLUUEESS
  125.      If the call to ssyyssccoonnff is not successful, -1 is returned and _e_r_r_n_o is set
  126.      appropriately.  Otherwise, if the variable is associated with functional-
  127.      ity that is not supported, -1 is returned and _e_r_r_n_o is not modified.
  128.      Otherwise, the current variable value is returned.
  129.  
  130. EERRRROORRSS
  131.      The ssyyssccoonnff() function may fail and set _e_r_r_n_o for any of the errors spec-
  132.      ified for the library functions sysctl(3).  In addition, the following
  133.      error may be reported:
  134.  
  135.      [EINVAL]      The value of the _n_a_m_e argument is invalid.
  136.  
  137. SSEEEE AALLSSOO
  138.      sysctl(3)
  139.  
  140. BBUUGGSS
  141.      The value for _SC_STREAM_MAX is a minimum maximum, and required to be the
  142.      same as ANSI C's FOPEN_MAX, so the returned value is a ridiculously small
  143.      and misleading number.
  144.  
  145. SSTTAANNDDAARRDDSS
  146.      The ssyyssccoonnff() function conforms to IEEE Std1003.1-1988 (``POSIX'').
  147.  
  148. HHIISSTTOORRYY
  149.      The ssyyssccoonnff function first appeared in 4.4BSD.
  150.  
  151. 4th Berkeley Distribution       April 19, 1994                               3
  152.